home *** CD-ROM | disk | FTP | other *** search
/ PC Home 62 / PC Home 62.iso / win3 / dragon / readme.txt < prev    next >
Encoding:
Text File  |  1997-05-24  |  38.3 KB  |  780 lines

  1.                                                                    
  2.                      =====================================
  3.                            T3 Dragon / CoCo Emulator
  4.                                   Version 0.8
  5.                       Copyright 1995-1997 by Paul Burgin
  6.                      =====================================
  7.   
  8.   1    Introduction
  9.   
  10.   Welcome to T3. T3 is a multi-tasking Dragon and Tandy CoCo II emulator for
  11.   80386 PCs and compatibles. Used in conjunction with a ROM file from one of
  12.   these  6809 based home computers, it enables you to run your old  software
  13.   on a modern PC.
  14.   
  15.   Note  that  a  ROM file is not included in the emulator distribution.  You
  16.   must  obtain  one from elsewhere before you can use T3 (see end  of  these
  17.   notes for a World Wide Web pointer to the ROM files).
  18.   
  19.   2    What Is Emulated
  20.   
  21.   The following components are emulated by T3:
  22.   ·    6809 CPU;
  23.   ·    Automatically emulates Dragon 32, Dragon 64 or Tandy CoCo II
  24.        compatible architecture as appropriate to the ROM file provided;
  25.   ·    All machines are provided with 64K of RAM, a switchable 16K BASIC
  26.        ROM, and a 16K ROM cartridge area;
  27.   ·    SAM chip with low/high/mid-resolution graphics, realistic text and
  28.        semi-graphics;
  29.   ·    Bi-directional cassette interface;
  30.   ·    6-bit and 1-bit audio output;
  31.   ·    Digital joysticks;
  32.   ·    Interrupt driven counter/timer mechanism (not 100% accurate).
  33.   
  34.   T3 also has additional features such as:
  35.   ·    Multiple sessions within a single instance of T3;
  36.   ·    Pre-emptive multitasking;
  37.   ·    Snapshot and image facilities;
  38.   ·    Variable speed control;
  39.   ·    Audio mute and volume control.
  40.   
  41.   The following are not emulated by this version of T3 (some of the items in
  42.   this list may be implemented at a later date, and others won't):
  43.   ·    Disk drives;
  44.   ·    Serial port / parallel port;
  45.   ·    Analogue joysticks;
  46.   ·    Joysticks via the PC mouse or joystick.
  47.   
  48.   3    System Requirements
  49.   
  50.   The minimum system specification is shown below. T3 will not start if your
  51.   system does not meet these requirements:
  52.   ·    80386 processor;
  53.   ·    MS-DOS v4.00;
  54.   ·    VGA graphics adapter;
  55.   ·    199K of base memory (approx.).
  56.   
  57.   The following is the recommended system specification for running a single
  58.   session with full speed and functionality:
  59.   ·    80386 DX-25 or above;
  60.   ·    MS-DOS v7.00 (Windows 95) or above;
  61.   ·    VGA or SVGA graphics adapter;
  62.   ·    SoundBlaster v1.0 or above;
  63.   ·    199K of base memory (approx.).
  64.   
  65.   If  you have additional base memory available then you will be able use T3
  66.   to  run  more  than one Dragon/CoCo session (task) at once.  Approximately
  67.   133K  of  base memory is required for each additional task (subject  to  a
  68.   maximum of four tasks).
  69.   
  70.   If  you have additional processing power available then you can choose  to
  71.   have  T3  execute  all of your tasks simultaneously. Tasks  then  continue
  72.   running even when switched into the background. When T3 is used for multi-
  73.   tasking smoother emulation should be obtained for faster CPUs.
  74.   
  75.   4    What Does T3 Mean?
  76.   
  77.   Well,  it's  nothing to do with that pop group, of that you can  be  sure!
  78.   There  is  also now a magazine called T3, but again this emulator  has  no
  79.   connection with that magazine.
  80.   
  81.   Although it still hasn't reached v1.00 and a wider distribution, T3 has in
  82.   fact been around for nearly two years. The name T3 was originally intended
  83.   to be only a working title, being an extreme contraction of "PC-Dragon III
  84.   (386  Turbo  Edition)". This name was conceived at  a  time  when  T3  was
  85.   expected  to re-use code from my previous emulator PC-Dragon II.  However,
  86.   it  turned out that code re-use was not practical and as a result  T3  has
  87.   been written from scratch as a new emulator in it's own right.
  88.   
  89.   Nevertheless, the name has now become familiar and so it would be somewhat
  90.   confusing to change it at this stage. It will therefore remain as T3 until
  91.   such  a  time  as  I  can  think of something  better!  If  you  have  any
  92.   suggestions then please let me know!
  93.   
  94.   5    Files In The T3 ZIP File
  95.   
  96.   The following files are supplied in the ZIP file:
  97.   
  98.   WHATSNEW.008        Summary of changes for this release.
  99.   README.TXT          Instructions (this file).
  100.   T3.EXE              T3 executable.
  101.   T3.DAT              T3 title page (can be deleted to save space).
  102.   
  103.   6    Getting Started
  104.   
  105.   To  begin  using the emulator you need to copy a ROM file  into  the  same
  106.   directory as T3.EXE. Having done so type "T3" to start the emulator.
  107.   
  108.   T3  tries a variety of different names when it searches for a ROM file and
  109.   will  use  the first file that it finds. Valid names include  T3,  DRAGON,
  110.   DRAGROM,  COCO,  TANDYROM, and D64ROM1. You can use files  either  in  PC-
  111.   Dragon  II's  DGN format or in Jeff Vavasour's ROM format; T3 auto-detects
  112.   which format you are using irrespective of the file name.
  113.   
  114.   If  you  have several ROM files and want to use a particular one then  you
  115.   can do this by specifying the -r option on the command line when you start
  116.   T3. E.g.
  117.   
  118.                                 T3  -rCOCO.ROM
  119.   
  120.   Note  that  if  the ROM file name includes a space then you will  need  to
  121.   enclose the entire option in double quotes. E.g.
  122.   
  123.                             T3 "-rD32 AND ALLDREAM"
  124.   
  125.   If  you are using T3 to emulate a Dragon 64 and want to use the 64K  BASIC
  126.   mode  then you will additionally need the 64K BASIC ROM. This must  be  in
  127.   DGN format and have file name D64ROM2.DGN.
  128.   
  129.   Once started press any key to proceed from the title page and T3 will boot
  130.   your Dragon or CoCo. When you wish to quit the emulator press F12 followed
  131.   by END and then RETURN.
  132.   
  133.   7    Emulator Controls
  134.   
  135.   The  following  are  key combinations which can be  used  to  control  the
  136.   emulator:
  137.   
  138.   F1                  Display emulator version.
  139.   F2                  Load image (hold SHIFT to save image).
  140.   F3                  Load snapshot (hold SHIFT to save snapshot).
  141.   F4                  Cassette mode control.
  142.   F5                  Jump to Alldream.
  143.   F6                  Jump to Dreambug.
  144.   F9                  Previous task.
  145.   F10                 Next task.
  146.   F11                 Create new task.
  147.   F12                 Delete current task (hold SHIFT to auto-save image).
  148.   
  149.   Alt-A               Artifacting control.
  150.   Alt-C               Cursor keys control.
  151.   Alt-F               Audio resampling frequency control.
  152.   Alt-L               Lower case text toggle.
  153.   Alt-P               Suspend task (i.e. pause).
  154.   Alt-Q               Audio on/off control.
  155.   Alt-R               Resume task.
  156.   Alt-S               Speed control.
  157.   Alt-T               Text colour control.
  158.   Alt-V               Audio volume control.
  159.   Alt-X               Task type control.
  160.   
  161.   SCROLL LOCK         Freeze task.
  162.   Ctrl-Alt-Delete     Warm reset (hold SHIFT for cold reset).
  163.   
  164.   Additionally, PGUP has the same function as F9, PGDN has the same function
  165.   as  F10,  INSERT  has  the same function as F11 and DELETE  has  the  same
  166.   function as F12.
  167.   
  168.   F8 has the same function as Ctrl-Alt-Delete. It is not needed when running
  169.   T3  in MS-DOS, but should be used when running T3 in environments where it
  170.   is  not  safe to press Ctrl-Alt-Delete (e.g. when running T3 in a DOS  box
  171.   under MS-Windows).
  172.   
  173.   The  NUM  LOCK key can be used instead of the Alt keys in order to prevent
  174.   joystick fire button being pressed.
  175.   
  176.   The following keys can be used in file name input dialogue boxes:
  177.   
  178.   F4                  Paste Dragon/CoCo name.
  179.   DELETE              Backspace.
  180.   HOME                Erase all.
  181.   ESC                 Quit.
  182.   RETURN              Accept.
  183.   
  184.   Additionally Ctrl-Alt-Delete, F8 and F12 have the same function as ESC.
  185.   
  186.   The following keys can be used in selection boxes:
  187.   
  188.   LEFT                Previous option.
  189.   RIGHT               Next option.
  190.   UP                  First option.
  191.   DOWN                Last option.
  192.   ESC                 Quit.
  193.   RETURN              Accept.
  194.   
  195.   Additionally  HOME has the same function as UP. END has the same  function
  196.   as DOWN. Ctrl-Alt-Delete, F8 and F12 have the same function as ESC.
  197.   
  198.   8    Video
  199.   
  200.   T3  fully emulates the default Dragon/CoCo text mode and all semi-graphics
  201.   modes.  It is also possible to select either realistic or idealistic  text
  202.   mode  colours by pressing Alt-T. With true text colours "ON"  the  colours
  203.   will  be either dark green on green or dark red on light orange. With true
  204.   text colours "OFF" the colours match with low-resolution graphics and will
  205.   be  either  black on green or black on orange (this improves the  look  of
  206.   games like Copta Snatch and Tetras).
  207.   
  208.   High/mid-resolution graphics modes are available in 2-colour  or  4-colour
  209.   palettes,  as provided by the Dragon/CoCo. All 2-colour black/white  modes
  210.   are also available in artifacted colours by pressing Alt-A and selecting a
  211.   "RED" artifacted palette or a "BLUE" artifacted palette.
  212.   
  213.   All  28 "regular" high/mid-resolution graphics modes are supported by  T3.
  214.   In  this context "regular" means modes where the number of bytes displayed
  215.   for  each scan line is equal to the video memory increment for each  line.
  216.   Other modes where video memory is skipped or repeated will be displayed as
  217.   the nearest equivalent regular mode instead.
  218.   
  219.   As  there  is  no  worthwhile reason to implement the irregular  modes  (I
  220.   haven't found any commercial software which uses them), it's very unlikely
  221.   that they shall ever be implemented by T3 (note however that PC-Dragon  II
  222.   does implement all of them).
  223.   
  224.   T3  implements an additional 4 mid-resolution graphics modes with 16 lines
  225.   of 16 bytes (total 256 bytes) which do not exist on the CoCo/Dragon! Refer
  226.   to  the  virtual  cassette  MODES.CAS supplied  with  PCDGN201.ZIP  for  a
  227.   demonstration of all of the high/mid-resolution graphics mode classes.
  228.   
  229.   9    Audio
  230.   
  231.   T3  provides emulation of Dragon/CoCo audio by using a SoundBlaster  card,
  232.   if installed. There is no option to hear audio via the PC beeper.
  233.   
  234.   In  order  to  receive audio you must ensure that your BLASTER environment
  235.   variable is set correctly when you start T3. This should contain a  string
  236.   such  as "A220" to specify the base IO address of your SoundBlaster.  When
  237.   running  under  Windows  95,  the string will  normally  be  set  for  you
  238.   automatically,  but  under  MS-DOS you  will  need  to  set  the  variable
  239.   yourself.  Typically this involves adding a command such as the  following
  240.   to  your  AUTOEXEC.BAT (but the settings must reflect the actual  hardware
  241.   settings of your card):
  242.   
  243.                             SET BLASTER=A220 I5 D1
  244.   
  245.   Unfortunately SoundBlaster cards provide a very slow response to software.
  246.   Because  of this, T3 cannot afford to wait for the SoundBlaster to respond
  247.   to  audio output on demand. Instead, T3 resamples all audio output at run-
  248.   time.
  249.   
  250.   By  default  T3  uses  a  resampling frequency of  16KHz,  which  provides
  251.   satisfactory results for most games. However, you may wish to  change  the
  252.   frequency  when  the default is not ideal for the software  that  you  are
  253.   using.  To  do  this,  press Alt-F and select a new  resampling  frequency
  254.   between 4KHz and 40KHz. Software which uses 1-bit sound rather than  6-bit
  255.   sound  typically  requires  higher  resampling  frequencies  (e.g.  Planet
  256.   Invasion, Intergalactic Force).
  257.   
  258.   Note  that the resampling frequency is relative to the task target  speed,
  259.   thus  if  you  increase  the target speed of a task  then  the  resampling
  260.   frequency  is  also proportionately increased. Dramatically  increasing  a
  261.   task   target  speed  without  reducing  the  resampling  frequency   will
  262.   eventually cause a minor reduction in the emulator's efficiency.
  263.   
  264.   Audio output can be toggled on and off by pressing Alt-Q. The volume level
  265.   may be adjusted by pressing Alt-V.
  266.   
  267.   10   Music
  268.   
  269.   The  default  audio  settings are satisfactory  for  most  sound  effects.
  270.   However,  if  you intend to use T3 to play music (or other sounds  lasting
  271.   longer  than  a quarter of a second at 100% speed) then you will  need  to
  272.   take  note  of the following recommendations for improving the quality  of
  273.   the music reproduction (in decreasing order of importance):
  274.   
  275.   1.   Audio  output  will be fragmented if a task is being timesliced  with
  276.        other tasks. For best results set the task type to "EXCLUSIVE".
  277.   
  278.   2.   Although  the  dynamic speed adjustments made by T3 are  not  usually
  279.        noticeable, when playing music they become very obvious as changes in
  280.        the  pitch  of  notes.  It is therefore highly recommended  that  the
  281.        dynamic target speed be set to "OFF" when playing music. To do  this,
  282.        allow  the music to play for awhile and then press Alt-S followed  by
  283.        HOME and RETURN. See also the notes in the Target Speed section.
  284.   
  285.   3.   Depending on the software in use, increasing the resampling frequency
  286.        may  provide noticeable improvements to the audio quality. To do this
  287.        press Alt-F (see previous section).
  288.   
  289.   4.   Quitting  MS-Windows environments and running T3 in pure  MS-DOS  can
  290.        provide minor improvements to the audio quality.
  291.   
  292.   11   Joysticks
  293.   
  294.   Joysticks are emulated using the PC cursor keys (but can be disabled using
  295.   Alt-C).  Both of the left and right joysticks are operated simultaneously,
  296.   but the fire buttons may be operated separately.
  297.   
  298.   Press  the  left Ctrl key or right Alt key to simulate the  left  joystick
  299.   fire  button.  Press the left Alt key or right Ctrl key  to  simulate  the
  300.   right  joystick fire button. Pressing the keypad 5 key will simulate  both
  301.   fire buttons at once.
  302.   
  303.   The  joystick emulation is digital rather than analogue and therefore will
  304.   not work with all games.
  305.   
  306.   12   Virtual Cassettes
  307.   
  308.   When the Dragon/CoCo requires access to cassettes you will be prompted for
  309.   the name of an MS-DOS file to be used as a virtual cassette.
  310.   
  311.   Type the name in the box with or without a CAS extension and press RETURN.
  312.   Pressing F4 pastes the name of the file that the Dragon/CoCo is attempting
  313.   to  access (if any) into the box, but you can only enter well formed names
  314.   so some characters may be translated to underscores.
  315.   
  316.   If you are running T3 with MS-DOS v7.00 or above and IFSHLP loaded (i.e. a
  317.   DOS  box  in Windows 95) then you can type up to 250 characters  including
  318.   upper  case  letters, lower case letters, numbers, special characters  and
  319.   spaces. If running T3 with an earlier version of MS-DOS or without  IFSHLP
  320.   loaded  (i.e.  MS-DOS  mode in Windows 95) then  you  can  enter  only  75
  321.   characters  which  may  include upper case letters,  numbers  and  special
  322.   characters.  If  long file names are available then the  cursor  is  blue,
  323.   otherwise it is grey.
  324.   
  325.   When  saving a cassette, should you enter the name of a file which already
  326.   exists  then  T3 will display the message "FILE EXISTS" and allow  you  to
  327.   choose  to  cancel the file name, append to the existing file, or  replace
  328.   it.
  329.   
  330.   T3  does  not  impose a limit on the length of cassette  files.  They  are
  331.   normally closed when the file mode changes or if you reset or quit a task,
  332.   but  can also be closed manually by pressing F4 and selecting CLOSED.  You
  333.   will need to do this to write separate programs consecutively to different
  334.   MS-DOS files, to recover from an ?IO ERROR, or to enter a file name  after
  335.   pressing Quit.
  336.   
  337.   Unlike  all  other  emulation performed by T3, the cassette  emulation  is
  338.   implemented  at the operating system level rather than the hardware  level
  339.   (ROM  breakpoints are installed at start-up). Cassette emulation therefore
  340.   does  not  work for the (very small number of) programs which  access  the
  341.   cassette mechanism at the hardware level.
  342.   
  343.   If  running multiple timesliced tasks then background tasks are  permitted
  344.   to   momentarily  interrupt  foreground  tasks  in  order  to  prompt  for
  345.   filenames.
  346.   
  347.   13   Cartridges
  348.   
  349.   There are two ways to load a cartridge into T3. Firstly, if you would like
  350.   the cartridge to be loaded at boot-up time then you must append it to your
  351.   ROM file. To do this type an MS-DOS command such as the following:
  352.   
  353.                 COPY  /B  DRAGON.DGN  +  CART.RAW  DRAGCART.DGN
  354.                                 T3  -rDRAGCART
  355.   
  356.   Note that your cartridge must be in a raw (pure data only) format.
  357.   
  358.   The  second  method of loading a cartridge into T3 is to  use  a  snapshot
  359.   file.  This is usually the best way to load cartridge games into  T3.  See
  360.   later section on snapshot files for more details.
  361.   
  362.   Whichever  method  of  loading a cartridge is used,  it  may  or  may  not
  363.   automatically execute, depending on how it was designed.
  364.   
  365.   If  you  load the Alldream cartridge into the emulator then the F5 and  F6
  366.   keys  can  be used to immediately jump to Alldream (F5) or Dreambug  (F6).
  367.   The  exact  function performed by F5 is: push PC register onto the  stack,
  368.   push the value of ($FFFE) onto the stack, push $C000 onto the stack, clear
  369.   the  I flag in the condition code register, and finally execute a jump  to
  370.   $A93A.  This  has the effect of returning to text mode and then  executing
  371.   Alldream.  When  you quit Alldream a reset occurs. F6  performs  the  same
  372.   function except that $D384 is pushed onto the stack rather than $C000.
  373.   
  374.   Remember  that  in order for Alldream/Dreambug to function correctly,  the
  375.   CLEAR  command  should be used to set-up their workspace before  they  are
  376.   executed. A warning will appear if you do not do this.
  377.   
  378.   14   Images
  379.   
  380.   Images are copies of the entire workspace of a T3 task. Image support  was
  381.   initially  implemented in order to aid debugging of the emulator  but  has
  382.   now  been made available for general use. The use of images allows you  to
  383.   save the context of a task to continue at a later date, or perhaps save  a
  384.   position in a game for instant replay.
  385.   
  386.   To  save  an  image  simply press SHIFT + F2. The  current  task  is  then
  387.   immediately saved to disk. It can be reloaded at any time by pressing  F2.
  388.   All  task  settings and ROMs are saved in the image, so that the  reloaded
  389.   task state is identical to the saved state.
  390.   
  391.   Note that T3 provides access to just one image file at a time. It does not
  392.   prompt for a file name when you load or save an image. However you can use
  393.   the -i command line option to change the image file name when you start T3
  394.   (see notes on -r option for applicable syntax).
  395.   
  396.   Note  also  that  images should not be considered to be snapshots  because
  397.   they  are  much  larger  than snapshots need to be, and  are  non-portable
  398.   between  emulators (or even between different versions  of  T3).  Use  the
  399.   snapshot facility instead if you need to make files portable.
  400.   
  401.   15   Automatic Images
  402.   
  403.   T3  can also create "automatic" images which are used slightly differently
  404.   to  standard images. To save an automatic image hold down SHIFT  when  you
  405.   delete a standard task and you will be given the option of auto-saving it.
  406.   After  doing  so,  when  you  next start  T3  the  image  will  be  loaded
  407.   automatically, creating an "automatic" task.
  408.   
  409.   Automatic  tasks behave slightly differently to standard tasks;  they  are
  410.   automatically  saved  when deleted. Also, some T3  messages  are  slightly
  411.   different,  and to protect the integrity of the task and the copyright  of
  412.   the emulator some control keys and command line options are unavailable.
  413.   
  414.   Automatic  images can be saved and loaded at any time by pressing  F2  and
  415.   SHIFT + F2 as usual.
  416.   
  417.   You can prevent T3 from loading an automatic image by deleting or renaming
  418.   it  (file name IMAGE.T3), or by using the -a command line option when  you
  419.   run  T3.  This  is  the only permitted command line option  for  automatic
  420.   tasks. Syntax as follows:
  421.   
  422.   -a0                 Ignore any image.
  423.   -a1                 Load any image as an automatic task.
  424.   -a                  Automatic toggle (equivalent to -a0 or -a1 as
  425.                       appropriate).
  426.   
  427.   The following are the only valid control keys for automatic tasks:
  428.   
  429.   F2                  Load image (hold SHIFT to save image).
  430.   F9                  Previous task.
  431.   F10                 Next task.
  432.   F12                 Auto-save image (hold SHIFT to delete task).
  433.   
  434.   Alt-F               Audio resampling frequency control.
  435.   Alt-P               Suspend task (i.e. pause).
  436.   Alt-Q               Audio on/off control.
  437.   Alt-R               Resume task.
  438.   Alt-S               Speed control.
  439.   Alt-V               Audio volume control.
  440.   Alt-X               Task type control.
  441.   
  442.   SCROLL LOCK         Freeze task.
  443.   
  444.   Automatic images have one particularly specialised use; they can  be  used
  445.   to  create  executable PC programs from Dragon/CoCo programs. To  do  this
  446.   proceed as follows:
  447.   
  448.   1.   Run  T3  as  normal, and load the Dragon/CoCo program from an  image,
  449.        snapshot, or virtual cassette.
  450.   
  451.   2.   Use  the emulator control keys to ensure that the cursor keys,  lower
  452.        case,  and  text  colour  task settings are correct  for  the  loaded
  453.        program.
  454.   
  455.   3.   From the title page of the program, press SHIFT + F12 to auto-save an
  456.        image of the program.
  457.   
  458.   4.   You can now create an executable Dragon/CoCo program on a floppy disk
  459.        by typing:
  460.   
  461.                          COPY  T3.EXE  A:\PROGNAME.EXE
  462.                               COPY  IMAGE.T3  A:\
  463.                                        
  464.   5.   PROGNAME.EXE  can be run on any 80386 PC with MS-DOS v4.00  or  above
  465.        and  a VGA graphics adapter. It will start immediately and will  have
  466.        persistent  data each time it is run (thus retaining progress  in  an
  467.        adventure  game,  or preserving hi-score tables in  an  arcade  game,
  468.        etc.).
  469.   
  470.   16   Snapshots
  471.   
  472.   Snapshots  are  minimal task images which are portable  between  different
  473.   Dragon/CoCo emulators, and future versions of T3.
  474.   
  475.   To  load a snapshot into T3 simply press F3 and type the filename  of  the
  476.   snapshot  that you wish to load. If you do not give an extension then  PAK
  477.   will  be  assumed, but snapshots may not always have this extension.  They
  478.   may  also  have  extensions  D32,  D64,  D96  or  CCO  to  indicate  which
  479.   architecture  they are intended for. Snapshots do not contain  BASIC  ROMs
  480.   and  therefore you must ensure that a task is initialised with the correct
  481.   architecture before loading a snapshot. It is usually best to  create  (or
  482.   cold  reset)  a task and wait until it is fully booted  before  loading  a
  483.   snapshot,  otherwise  the  interrupts and IO  registers  may  not  be  set
  484.   correctly.
  485.   
  486.   If  you  load a snapshot with a start address of $C000 then T3 will assume
  487.   that it is a cartridge game and will perform an FIRQ to execute it.
  488.   
  489.   T3  can  load  snapshots in either v1.4 or v1.5 format, as  used  by  Jeff
  490.   Vavasour's CoCo II emulator. It can also load snapshots saved by PC-Dragon
  491.   II  but  only  if  the  format  is v1.4 (or compressed  v1.4).  Any  other
  492.   snapshots  will  need to be converted to v1.4 format before  they  can  be
  493.   loaded  by  T3  (this  conversion can be performed  using  PC-Dragon  II).
  494.   Compatibility with snapshots created by DREaM is untested at the  time  of
  495.   writing.
  496.   
  497.   To  save  a  snapshot press SHIFT + F3 and type in the  filename  for  the
  498.   snapshot. Again if no extension is given then PAK is appended. If the file
  499.   already  exists then you will be given a choice of replacing the  existing
  500.   file or entering a different name.
  501.   
  502.   Snapshots saved by T3 use an uncompressed v1.4 format compatible with Jeff
  503.   Vavasour's  CoCo  II  emulator v1.4 or v1.5, and also with  PC-Dragon  II.
  504.   However,  note  that T3 does not save any emulator settings in  snapshots,
  505.   thus  if you load a snapshot saved by another emulator into T3 and re-save
  506.   it  then you will lose any settings used by the other emulator. Also  note
  507.   that  T3  always  automatically minimises  the  amount  of  RAM  saved  in
  508.   snapshots, which may cause difficulties if you load a T3 snapshot into PC-
  509.   Dragon II and re-save it. To avoid any potential problems always reset the
  510.   snapshot length to $8000 or $FF00 before re-saving a T3 snapshot using PC-
  511.   Dragon II (press F4, 5, 2 and then enter 8000 or FF00 as appropriate).
  512.   
  513.   Beware that because the snapshot format does not include all IO registers,
  514.   you  may sometimes find that you hear no audio when you reload a snapshot.
  515.   This  can  usually be fixed by typing the following BASIC  command  before
  516.   loading the snapshot:
  517.   
  518.                                 POKE &HFF23, 63
  519.   
  520.   Since  ROM  is not saved in snapshots, if you are running cartridge  based
  521.   software then you will need to reload both the cartridge and RAM snapshots
  522.   in  order to restore the emulator state using snapshots. In this situation
  523.   it  may  be more convenient to use images, because these include both  RAM
  524.   and ROM.
  525.   
  526.   T3  uses  the same buffer area for snapshots as cassettes, thus  accessing
  527.   the  snapshot  facilities will force any open cassette to be closed.  This
  528.   version  of  T3  does  not  buffer the memory  areas  held  in  compressed
  529.   snapshots,   thus   loading   them  is  quite   slow   and   the   message
  530.   "DECOMPRESSING..." will appear.
  531.   
  532.   17   Multi-Tasking
  533.   
  534.   When  T3 is started it will emulate just one Dragon/CoCo. However, if  you
  535.   have   spare   base  memory  available  then  you  can  create  additional
  536.   Dragon/CoCo  sessions at any time by pressing the F11 key (or INSERT).  T3
  537.   then  spawns and boots a new Dragon/CoCo session (or task) and  moves  the
  538.   previously executing Dragon/CoCo task into the background.
  539.   
  540.   Each  new task is entirely independent of other tasks, receiving it's  own
  541.   RAM,  ROMs  and  emulator  workspace (includes settings,  keyboard  state,
  542.   cassette  buffer, text font etc.). The ROMs for the new  task  are  copied
  543.   from  the  current  task  when the new task is created,  but  the  RAM  is
  544.   cleared.
  545.   
  546.   Once  you have more than one task running under T3, you can switch between
  547.   them at any time by pressing F10 (or PGDN) to switch to the next task, and
  548.   F9  (or  PGUP)  to switch to the previous task. Unwanted tasks  should  be
  549.   deleted  in  the  usual  way by pressing F12 (or  DELETE).  T3  will  then
  550.   terminate the current task and switch to the next remaining task, if any.
  551.   
  552.   In  addition to allowing a variable number of tasks to be created,  T3  is
  553.   also capable of executing the tasks simultaneously. It does so using a pre-
  554.   emptive  multi-tasking  executive  which  switches  context  between   the
  555.   available tasks up to 17 times per second (switching is synchronised  with
  556.   Dragon/CoCo  interrupts in order to reduce game flicker and  is  therefore
  557.   slower for slower PCs). Even on very fast PCs, the multi-tasking may cause
  558.   game motion to be jerky and keyboard responsiveness to be less sensitive.
  559.   
  560.   By  default  all tasks are executed exclusively rather than timesliced  in
  561.   this manner. However, pressing Alt-X when two or more tasks exist causes a
  562.   task  type selection box to appear. The type of the current task can  then
  563.   be  set to either "EXCLUSIVE" or "TIMESLICE". If the type of a task is set
  564.   to  "EXCLUSIVE"  then  it  will not execute at  all  when  it  is  in  the
  565.   background, and will not allow any other tasks to execute whilst it is  in
  566.   the foreground.
  567.   
  568.   By  contrast, if set to "TIMESLICE" then a task will share processing time
  569.   with  any  other  "TIMESLICE"  tasks whenever  any  of  them  are  in  the
  570.   foreground.  Each "TIMESLICE" tasks receives an equal share of  processing
  571.   time  irrespective of their target speed and irrespective of whether  they
  572.   are in the foreground or the background.
  573.   
  574.   Any tasks which are suspended or frozen do not receive a timeslice even if
  575.   they are in the foreground, thus suspending or freezing a "TIMESLICE" task
  576.   may  cause other "TIMESLICE" tasks to execute more quickly (this  will  be
  577.   the  case  whenever a task is currently executing slower than it's  target
  578.   speed).
  579.   
  580.   Note  that because tasks are independent, they each require a lot of  base
  581.   memory  (133K  per  task). This limits the number of tasks  which  can  be
  582.   created  by  T3  to  four for a minimally booted PC, or two/three  for  an
  583.   average  PC  set-up.  Future versions of T3 may allow  more  tasks  to  be
  584.   created (e.g. by allowing ROM sharing, or by swapping exclusive tasks into
  585.   EMS/XMS),  but in the meantime it is of course possible to run  more  than
  586.   four  Dragon/CoCo tasks by using an environment such as MS-Windows or  MS-
  587.   DOS v5.00/v6.00 DOSSHELL in order to run more than one instance of T3.
  588.   
  589.   18   Target Speed
  590.   
  591.   Each  task has an independent target speed setting. T3 assesses the  speed
  592.   of  each task relative to the target setting for every 25 Dragon/CoCo  IRQ
  593.   periods executed (this equates to approximately every half a second if the
  594.   target  speed is 100%). The average instruction execution speed  for  each
  595.   task  is  then  adjusted, where necessary, in order to meet the  requested
  596.   target speed as closely as possible.
  597.   
  598.   Note  that  the  dynamic execution speed adjustments  are  made  in  small
  599.   increments  (or decrements). It therefore takes a few seconds  for  T3  to
  600.   make  any  necessary  speed  adjustments whenever  "TIMESLICE"  tasks  are
  601.   created, deleted, suspended, frozen or resumed.
  602.   
  603.   If the target speed for a task is set to "MAX" then the execution speed of
  604.   that  task  is not measured or adjusted. The task simply runs as  fast  as
  605.   possible.
  606.   
  607.   The dynamic speed adjustment of a task may also be turned off by selecting
  608.   target  speed  "OFF". The delay factor for the task is then fixed  at  the
  609.   current  value  when "OFF" is selected. This is not usually necessary  but
  610.   will give greatly improved music reproduction. Note, however, that if  you
  611.   turn  dynamic  speed adjustment off for a "TIMESLICE" task then  creating,
  612.   deleting,  suspending,  freezing or resuming any other  "TIMESLICE"  tasks
  613.   will have a dramatic impact on the execution speed of the task because  T3
  614.   will not be allowed to compensate for the change in number of tasks.
  615.   
  616.   19   Emulator Compatibility
  617.   
  618.   The  following  table shows T3 compatibility for various platforms.  Where
  619.   "?"  is shown, compatibility is unknown. Where "*" is shown, compatibility
  620.   is  unknown  but has been guessed. If you can provide information  on  the
  621.   details  which  are  unknown, or believe others to  be  wrong,  please  do
  622.   contact me at the address provided at the end of these notes.
  623.   
  624.          Platform           | Run T3 | Long Filenames | Audio
  625.          -------------------+--------+----------------+--------
  626.          MS-DOS v1.xx-v3.xx |   NO   |       NO       |   NO
  627.          MS-DOS v4.xx-v6.xx |  YES   |       NO       |  YES
  628.          Windows 3.1x       |  YES   |       NO       |  YES
  629.          Windows 95         |  YES   |      YES       |  YES
  630.          Windows NT         |  YES   |       NO       |   ?
  631.          OS/2               |  YES   |       NO       |  YES*
  632.          SoftWindows        |   NO   |       NO       |   NO
  633.          DR-DOS             |   NO*  |       NO       |   NO
  634.          Novell DOS v?      |  YES*  |       NO       |  YES*
  635.          PC-DOS v1.xx-v4.00 |   NO*  |       NO       |   NO
  636.          PC-DOS v4.01+      |  YES*  |       NO       |  YES*
  637.   
  638.   20   Frequently Asked Questions
  639.   
  640.   People  ask me a lot of questions about T3 and the Dragon/CoCo  scene,  so
  641.   please  check  to  see if the answer to your question is here  before  you
  642.   write to me. Thanks.
  643.   
  644.   Q.   Where can I download T3 updates?
  645.   
  646.   A.    The  latest  version of T3 is held on my web site.  The  address  is
  647.   "http://public.logica.com/~burginp/t3.html".  Please  feel  free  to  make
  648.   links to this page, but do not link directly to the ZIP file because  your
  649.   link will be invalidated when the ZIP is updated. A new version of T3 will
  650.   be available from SimTel mirror sites in the near future.
  651.   
  652.   Q.   Where on the Internet can I find the ROM files?
  653.   
  654.   A.   You can get the ROM files for the Dragon 32, Dragon 64 and Tandy CoCo
  655.   II  from  at least one site on the Internet. Try Ross Hamilton's web  site
  656.   and David Linsley's web site. You can also find links to these from my own
  657.   web  site,  but for copyright reasons the files are not stored there.  Try
  658.   the                            following                           address
  659.   "http://public.logica.com/~burginp/emulators.html#roms".
  660.   
  661.   Q.   Why don't you include the ROM files?
  662.   
  663.   A.    I  don't  include them because I have no right to do  so.  They  are
  664.   copyrighted,  and  as  much as we may dislike it, that  copyright  remains
  665.   valid.  I  agree  that  it  is very unlikely that  I  would  be  sued  for
  666.   infringing the copyright, but that is my risk and I choose not to take it.
  667.   Also,  including the ROMs in the emulator ZIP would force  any  person  or
  668.   site distributing the emulator to infringe the same copyright, which would
  669.   be  unfair on them. Moreover, some archive sites (including SimTel)  would
  670.   not  accept  T3  if  the ROMs were included. If you did receive  the  ROMs
  671.   together with the emulator then please drop me a line at the address given
  672.   at the end of these instructions.
  673.   
  674.   Q.   Why won't my ROM work?
  675.   
  676.   A.    This problem is almost always caused by your ROM file being corrupt.
  677.   You should obtain another copy, ensuring that you download in binary mode.
  678.   
  679.   Q.   Why won't the keyboard/joysticks work in <game>?
  680.   
  681.   A.    This problem is usually caused by the game taking exception  to  the
  682.   fact that by default T3 allows the PC cursor keys (standard and keypad) to
  683.   simultaneously emulate both the Dragon/CoCo joysticks and the  Dragon/CoCo
  684.   cursor keys. The solution is to use the Alt-C control to set the PC cursor
  685.   keys  to  emulate either the Dragon/CoCo joysticks only or the Dragon/CoCo
  686.   cursor keys only.
  687.   
  688.   Q.   How do I load this *.CAS format software into T3?
  689.   
  690.   A.    If the program is machine code format, type "CLOADM". This will work
  691.   for  most  software. If the OK prompt appears after loading then you  will
  692.   need  to  type  "EXEC". Remember to always perform  a  cold  reset  before
  693.   loading  each game into T3. If you still get unexpected results then  your
  694.   *.CAS file is probably corrupt. For software written in BASIC type "CLOAD"
  695.   and then "RUN".
  696.   
  697.   Q.    How  do  I  load  this *.PAK, *.D32, *.D64, *.D96  or  *.CCO  format
  698.   software into T3?
  699.   
  700.   A.    These extensions all indicate that the files snapshots. If they  are
  701.   v1.4  or v1.5 format (there's no way to tell) then they can be loaded into
  702.   T3  by  using the snapshot facilities (F3 key). If they are other versions
  703.   then  you will first need to use the PC-Dragon II emulator to convert them
  704.   to v1.4 format.
  705.   
  706.   Q.   How do I load this *.IMG format software into T3?
  707.   
  708.   A.   You can't. This software is an old T3 image, which is not portable to
  709.   this version of T3. Your only chance of loading it into the new version of
  710.   T3 is by converting it into a virtual cassette file (may not be easy).
  711.   
  712.   Q.   How can I load my old tapes into T3?
  713.   
  714.   A.    There are a few utilities around which enable tapes to be copied  to
  715.   files  on  your  PC  by  using a SoundBlaster  card.  Download  the  older
  716.   emulators  (PCDGN201.ZIP  and COCO2-15.ZIP)  and  read  the  documentation
  717.   provided there.
  718.   
  719.   Q.   How can I load my old disks into T3?
  720.   
  721.   A.   You can't. T3 does not support disk drive emulation. Your only option
  722.   is  to  transfer the software to another format (such as a cassette  file)
  723.   and  use  that. This is only possible for a small number of programs.  You
  724.   can transfer files from Dragon disks to PC disks using PC-CONVERT (contact
  725.   NDUG), and from CoCo disks using COCO2-15.ZIP. Raw disk format files  held
  726.   in  PC  format  can  be  converted  to  cassette  files  using  DC.EXE  in
  727.   PCDGN201.ZIP.
  728.   
  729.   Q.   Where can I get a copy of <some game>?
  730.   
  731.   A.    For Dragon games check Ross Hamilton's archive, a link to which  can
  732.   be         found         on         my         web         site         at
  733.   "http://public.logica.com/~burginp/dragon.html". If  you  can't  find  the
  734.   game  there then you will have to convert it to PC format yourself. Please
  735.   don't ask me to send it to you.
  736.   
  737.   Q.   Where can I buy hardware these days?
  738.   
  739.   A.    I  do not keep information about hardware suppliers, and cannot help
  740.   with this type of enquiry.
  741.   
  742.   Q.   Please help me with OS9, or with my Tandy <machine>?
  743.   
  744.   A.    I  have  no  knowledge of these, sorry, and  cannot  help  with  any
  745.   enquiries.
  746.   
  747.   Q.   Can I still register PC-Dragon II?
  748.   
  749.   A.    Yes you can. At the time of writing, the terms and conditions of the
  750.   original   registration  offer  are  unchanged.  Please   refer   to   the
  751.   documentation  provided in PCDGN201.ZIP. However, please note  that  snail
  752.   mail  should  not  be  sent to the address given there.  Instead  use:  18
  753.   Moorcroft Road, Sheffield, S10 4GS, England.
  754.   
  755.   21   Disclaimer
  756.   
  757.   If  you  choose  to use T3 then you do so entirely at your  own  risk.  No
  758.   warranty either implied or otherwise is provided for this software.  Usage
  759.   of T3 constitutes acceptance of these terms.
  760.   
  761.   22   Usage Restrictions
  762.   
  763.   T3  v0.8  is released to the public domain. It may be used and distributed
  764.   without  charge,  but  MUST  NOT be uploaded to  FTP  sites/WWW  sites  or
  765.   bulletin   boards.  T3  v1.0  will  be  made  available   for   widespread
  766.   distribution very soon, but until then I would like it to reside  only  at
  767.   "http://public.logica.com/~burginp/t3.html".
  768.   
  769.   23   Address For Comments And Bug Reports
  770.   
  771.   If  you  have  any  comments on T3 please do drop  me  a  message  at  the
  772.   following  address "BurginP@Logica.Com". If you are reporting a  bug  then
  773.   please  include as much information as possible (but please  do  not  send
  774.   binaries).
  775.   
  776.   If you have access to the World Wide Web then please refer to the notes at
  777.   "http://public.logica.com/~burginp/mail.html" before  sending  me  any  e-
  778.   mail.
  779.   
  780.